home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / slog.zip / SLOG.DOC < prev    next >
Text File  |  1991-08-13  |  5KB  |  172 lines
  1. DISCLAIMER :
  2.  
  3.   This program is distributed (AS IS) I will guarantee nothing.
  4.   I will not be responsible for any problems with your system due to the use
  5.   of this program . 
  6.  
  7.   This program has been tested , and WORKS , however improper use could
  8.   result in lost DATA . Please read and Understand the usage of this program
  9.   before you use it . 
  10.  
  11.   You should also understand the usage of the archive type you chose to store
  12.   your logs in IE: PKZIP , LHARC , Etc.
  13.  
  14.  
  15.  
  16. WHAT IT DOES :
  17.  
  18.   Store Log is a program I wrote to archive the logs on my BBS each day in
  19.   an event . The program will archive and store the log under the current
  20.   date and then delete your original log file (optional).
  21.  
  22. EXAMPLE :
  23.  
  24.   The date is 08-08-1991 and I want to archive my Remote Access log it
  25.   would look like this .
  26.  
  27.   SLOG C:\RA\LOG\RA.LOG
  28.  
  29.   The program would look in my directory c:\ra\log\ for a file name
  30.   RA.LOG and archive it as 08-08-91.ZIP, (USING PKZIP AS THE ARCHIVE'R) .
  31.  
  32.   You don't have to use Pkzip if you don't want to you may use any other
  33.   archive'r you like (refer to the SLOG.CFG file for more information).
  34.  
  35. DELETE:
  36.  
  37.   Then the program will delete the original log file (this is optional)
  38.   if you keep the old file the next time the program, is run it will
  39.   archive the same data defeating the purpose of SLOG .
  40.  
  41.   If you do not want to delete the original file you would put
  42.   DELETE,OFF on the line in the SLOG.CFG file
  43.  
  44.  
  45. ARCHIVE:
  46.  
  47.   When choosing an archive'r other than PKZIP you may have to also include
  48.   other data the program needs to create the archive .
  49.   lharc would need (LHARC A) on the config line marked Archive .
  50.   (Please read the DOC'S for the archive'r you use)
  51.   IE: ARCHIVE,LHARC A
  52.  
  53.   It is also important (NOT) to run the program more than once a day
  54.   (for each file archived) . If you ran SLOG at 12:00 archiving 
  55.   Dbridge.log  , and ran it again at 23:59 for Dbridge.log  it would 
  56.   over write the old part of the log  . 
  57.   
  58.   You can run it as many times as you like with different file names .
  59.   If you do this I would use the Update command in the the archive'r
  60.   sample line in SLOG.CFG, ( Archiver,PKZIP -U ) .
  61.  
  62.   I run it for three log files ,Dbridge.log,Binkley.log , and Ra.log
  63.   it will create one file with the current date as it's name ,and store
  64.   each of the three files  in the (ONE) Archive . 
  65.  
  66.   You would have to run the program three times , once for each log to 
  67.   be added to the archive . 
  68.  
  69. EXAMPLE :   
  70.  
  71.    c:
  72.    cd\logs
  73.    slog c:\db\log\dbridge.log
  74.    slog c:\binkley\binkley.log
  75.    slog c:\ra\ra.log
  76.    c:
  77.    cd\db
  78.  
  79.   This would (using PKZIP -U) go to the area I store my dated archived
  80.   files in , create one archive with the current date IE: XX-XX-XX.zip
  81.   store the three files in the archive , then return to original directory.
  82.  
  83. NOTE :
  84.  
  85.   When the program is run the archive will be placed in the directory 
  86.   where the SLOG is run from . This is why I change my directory to 
  87.   C:\logs\ (you should have SLOG in this directory), it also lets me view the 
  88.   logs easier when researching problems.
  89.  
  90.   Also you should have a path to the Archiver you are using .
  91.  
  92. EXAMPLE :
  93.  
  94.   AUTOEXEC.BAT
  95.   path= c:\;c:\dos;c:\pkzip
  96.  
  97.   If you don't understand how the path statement works please read your
  98.   DOS Manual for more information .  
  99.  
  100.  
  101. LOGNAME:
  102.  
  103.   This is the name of a log file SLOG will append to each time it is run
  104.   It will put the date time , and  file name that is stored .
  105.  
  106.   NOTE:
  107.   If you use (NONE) for the logname then SLOG will not create a log
  108.   file , LOGNAME,NONE in SLOG.CFG will not create a Log of its use. 
  109.  
  110.  
  111.  
  112.  
  113. Sample slog.cfg :
  114.  
  115. ; *** Please make note of the comma's they have, to be in this file ***
  116. ; *** and must be just before the option IE:( ARCHIVE,PKZIP -U ).   ***
  117. ;
  118. ;  Archive is the type of archive you want
  119. ;
  120. ; This can be any Archiver you want but you must put the complete
  121. ; Command line in with the name .
  122. ;
  123. ;     lha211 a -m
  124. ;     PKZIP -U
  125. ;     pak a
  126. ;     Pkarc a
  127. ;
  128. ARCHIVE,PKZIP -U
  129. ;
  130. ; delete is the command to tell slog to delete the log after archiving
  131. ; the default is to delete the old file .
  132. ; options are ON and OFF
  133. ;
  134. DELETE,ON
  135. ;
  136. ; logname is the name of the file that slog will create/append
  137. ; when it is run . If you use NONE then no log will be made .
  138. ;
  139. ;
  140. LOGNAME,SLOG.LOG
  141. ;
  142. ;
  143. END
  144.  
  145.  
  146.  Please remember this program is SHAREWARE , and you are required to
  147.  Register your copy after the 30 day trial period .
  148.  
  149.  All money that is collected will be used in the local school system,
  150.  and will be used to help students with reading problems .
  151.  
  152.  I will make nothing on this program , but you are encouraged to send
  153.  anything you can , it will help the Kids that really need help .
  154.  Remember to invest in our children , you are investing in our Future . 
  155.  
  156.  
  157.  Send donations payable to (Center Woods School)
  158.  
  159.                    C/O Jim Webb
  160.                    Route 4 , Box 505B
  161.                    Weare , Nh. 03281
  162.  
  163.  no amount to small :)
  164.  
  165.  Comments welcome  Jim Webb
  166.  
  167.    603-529-4290    FidoNet 1:132/137  (14.4k HST/DS/V.32/V.42)
  168.    603-529-3395    Fidonet 1:132/136  (2400 BPS)
  169.  
  170.  
  171.  
  172.